home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / sharexe.zip / UNSHAR.MAN < prev   
Text File  |  1988-02-21  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. UNSHAR(1)           UNIX Programmer's Manual            UNSHAR(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      unshar - unpack shell archives from news, mail, notes, etc.
  10.  
  11. SYNOPSIS
  12.      unshar [ -cdirectory ] [ -ddirectory ] [ -f ] [ -n ] [ -s ]
  13.      [files]
  14.  
  15. DESCRIPTION
  16.      Unshar removes mail and news header lines from its input,
  17.      and feeds the remainder to /bin/sh(1) so that a shell
  18.      archive can be properly unpacked.  If no files are speci-
  19.      fied, unshar reads from standard input.  The program is
  20.      designed to be useful when unpacking archives directly from
  21.      the news or mail systems (e.g., s | unshar).
  22.  
  23.      Unshar normally unpacks its files in the current directory.
  24.      Use the ``-c'' option to have the program change to a new
  25.      directory before invoking the shell.  If the directory does
  26.      not exist, it will try to create it.  If the directory name
  27.      starts with a question mark, then unshar will ask for the
  28.      directory name before doing anything; this is most useful
  29.      with the environment variable UNSHAREDIR.  If the directory
  30.      name starts with a tilde, then the value of the HOME
  31.      environment variable is inserted in place of that character.
  32.      For convenience, the ``-d'' option is a synonym for the
  33.      ``-c'' option.
  34.  
  35.      Unshar normally complains if the input looks like something
  36.      other than a shar file.  (Among other things, it checks for
  37.      files that resemble C, and Pascal code).  It can be fooled,
  38.      however, by nonstandard versions of news, notes, etc.  The
  39.      ``-f'' option forces unshar to try unpacking files, even if
  40.      they look like something else.
  41.  
  42.      Depending on how the program is installed, unshar may or may
  43.      not try to preserve the header part of file ``foo'' into the
  44.      name ``foo.hdr'' (if the file is standard input, the name
  45.      will be ``UNSHAR.HDR'').  Using the Using the ``-s'' option
  46.      forces the program to save the headers, while using the
  47.      ``-n'' option forces it to discard the headers.  The file is
  48.      appended to, if it already exists, so all headers can be
  49.      easily saved in one file.
  50.  
  51. ENVIRONMENT
  52.      HOME        Value used if a leading tilde is given in direc-
  53.      tory name.
  54.      UNSHAREDIR  Default value for ``-c'' option.
  55.  
  56. SEE ALSO
  57.      shar(1).
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Printed 2/21/88               LOCAL                             1
  64.  
  65.  
  66.  
  67.